home *** CD-ROM | disk | FTP | other *** search
/ CU Amiga Super CD-ROM 23 / CU Amiga - Super CD-ROM 23 (June 1998).iso / CUCD / Online / weazel / doc / weazel.doc < prev   
Encoding:
Text File  |  1998-03-30  |  3.8 KB  |  104 lines
  1.  
  2.                                 Weazel v1.1
  3.  
  4.                                by Nikola Fox
  5.                         aka the Orange Juice Jones
  6.  
  7.   [_] What is it?
  8.  
  9.       Weazel is a program that sends e-mail messages using extensions
  10.       to the POP3 protocol.
  11.  
  12.   [_] Why not just use SMTP?
  13.  
  14.       The ISP I use doesn't allow connections to SMTP hosts from dial in
  15.       machines. This is in order to prevent abuse of the lack of dial in 
  16.       authorisation (i.e. sending fake e-mail messages).
  17.  
  18.       On the other hand you can use POP3 to retrieve your mail freely,
  19.       because POP3 incorporates authorisation, so the server knows who you
  20.       are. Unfortunately the basic POP3 protocol only supports retrieving
  21.       e-mail - not sending.  A while ago some PC users I know started
  22.       telling me they can send e-mail using the Eudora software. It took me
  23.       a while to figure out this used a custom extension to the POP3
  24.       protocol for sending e-mail.
  25.  
  26.       Cool! - I thought. Now I just have to check out all the e-mail
  27.       clients on Aminet and see if any of them supports this extensions.
  28.       Unfortunately, none did.  Then I saw a neat feature in the Eucalyptus
  29.       e-mail client which allowed using of external programs to send and
  30.       receive mail.  This inspired me to write a program to send mail using
  31.       the POP3 extensions, and this is what you're looking at right now.
  32.  
  33.       I think the ISP I use is probably not the only one with such a
  34.       situation, so I release this program in hope other people will find
  35.       it useful as well.
  36.  
  37.   [_] So, how do I use it?
  38.  
  39.       The program is called from the CLI with only one argument - the
  40.       filename of the e-mail message to be sent. The message MUST contain
  41.       all the required headers like To: Subject: From: etc.
  42.  
  43.       It looks in ENV:WEAZEL for your username, password and POP3 server
  44.       to connect to. This dile must be present for the program to work.
  45.       Here's an example of what the file could look like:
  46.  
  47.       nfox
  48.       password1
  49.       jagor.srce.hr
  50.  
  51.       The program defaults to port 110 for the POP3 server. I never saw a
  52.       POP3 server running on a different port, but I'll add the option to
  53.       specify a different port in the next version.
  54.  
  55.       There's also a big security risk of your password being saved in the
  56.       config file. I'm still thinking about ways to avoid this. The next
  57.       version should have an option to enter the password during run-time
  58.       each time mail is sent.
  59.  
  60.       Although you can use this program directly from CLI, it is meant to
  61.       be used from an e-mail client.  I made it for use with Eucalyptus,
  62.       but you could probably use it with any other client that can use an
  63.       external program to send mail. Here's how to configure Eucalyptus to 
  64.       use it.
  65.  
  66.       Go to the Settings - Mail menu, and select the Send tab. Now choose
  67.       the External option, and type the following line in the Command
  68.       string gadget:
  69.  
  70.       C:weazel %f
  71.  
  72.       Substitute C: for wherever you have put the program.
  73.  
  74.   [_] Bugs?
  75.  
  76.       I haven't found any bugs, but that doesn't mean there aren't any.
  77.       If you think something's wrong with the program, e-mail me at:
  78.  
  79.       nfox@jagor.srce.hr
  80.  
  81.       and I will do my best to fix it.
  82.  
  83.       The program has only been tested with AmiTCP4.0 demo, and Miami 3.0.
  84.       I think it should work with other TCP stacks as well, but if it
  85.       doesn't let me know.
  86.  
  87.   [_] Thanks.
  88.  
  89.       Thanks go to Ivac for helping me figure out the POP3 extensions.
  90.  
  91.   [_] History.
  92.  
  93.       v1.1  -  v1.0 got confused if there were trailing newlines in the
  94.                config file. This bug is now fixed.
  95.  
  96.       v1.0  -  First working version.
  97.  
  98.   [_] Legal stuff.
  99.  
  100.       This program is freeware. This means you can copy and distribute it
  101.       freely as long as you don't charge anything more than the cost of
  102.       media for it.  
  103.  
  104.